home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / Xt / XtSetKeyTranslator.z / XtSetKeyTranslator
Encoding:
Text File  |  1998-10-30  |  5.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXttttSSSSeeeettttKKKKeeeeyyyyTTTTrrrraaaannnnssssllllaaaattttoooorrrr((((3333XXXXtttt))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))XXXXttttSSSSeeeettttKKKKeeeeyyyyTTTTrrrraaaannnnssssllllaaaattttoooorrrr((((3333XXXXtttt))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XtSetKeyTranslator, XtTranslateKeycode,
  10.           XtRegisterCaseConverter, XtConvertCase - convert KeySym to
  11.           KeyCodes
  12.  
  13.      SSSSYYYYNNNNTTTTAAAAXXXX
  14.           void XtSetKeyTranslator(_d_i_s_p_l_a_y, _p_r_o_c)
  15.               Display *_d_i_s_p_l_a_y;
  16.               XtKeyProc _p_r_o_c;
  17.  
  18.           void XtTranslateKeycode(_d_i_s_p_l_a_y, _k_e_y_c_o_d_e, _m_o_d_i_f_i_e_r_s,
  19.           _m_o_d_i_f_i_e_r_s__r_e_t_u_r_n, _k_e_y_s_y_m__r_e_t_u_r_n)
  20.               Display *_d_i_s_p_l_a_y;
  21.               KeyCode _k_e_y_c_o_d_e;
  22.               Modifiers _m_o_d_i_f_i_e_r_s;
  23.               Modifiers *_m_o_d_i_f_i_e_r_s__r_e_t_u_r_n;
  24.               KeySym *_k_e_y_s_y_m__r_e_t_u_r_n;
  25.  
  26.           void XtRegisterCaseConverter(_d_i_s_p_l_a_y, _p_r_o_c, _s_t_a_r_t, _s_t_o_p)
  27.               Display *_d_i_s_p_l_a_y;
  28.               XtCaseProc _p_r_o_c;
  29.               KeySym _s_t_a_r_t;
  30.               KeySym _s_t_o_p;
  31.  
  32.           void XtConvertCase(_d_i_s_p_l_a_y, _k_e_y_s_y_m, _l_o_w_e_r__r_e_t_u_r_n,
  33.           _u_p_p_e_r__r_e_t_u_r_n)
  34.               Display *_d_i_s_p_l_a_y;
  35.               KeySym _k_e_y_s_y_m;
  36.               KeySym *_l_o_w_e_r__r_e_t_u_r_n;
  37.               KeySym *_u_p_p_e_r__r_e_t_u_r_n;
  38.  
  39.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  40.           _d_i_s_p_l_a_y   Specifies the display.
  41.  
  42.           _k_e_y_c_o_d_e   Specifies the KeyCode to translate.
  43.  
  44.           _k_e_y_s_y_m    Specifies the KeySym to convert.
  45.  
  46.           _k_e_y_s_y_m__r_e_t_u_r_n
  47.                     Returns the resulting KeySym.
  48.  
  49.           _l_o_w_e_r__r_e_t_u_r_n
  50.                     Returns the lowercase equivalent of the KeySym.
  51.  
  52.           _u_p_p_e_r__r_e_t_u_r_n
  53.                     Returns the uppercase equivalent of the KeySym.
  54.  
  55.           _m_o_d_i_f_i_e_r_s Specifies the modifiers to the KeyCode.
  56.  
  57.           _m_o_d_i_f_i_e_r_s__r_e_t_u_r_n
  58.                     Returns a mask that indicates the modifiers
  59.                     actually used to generate the KeySym.
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXttttSSSSeeeettttKKKKeeeeyyyyTTTTrrrraaaannnnssssllllaaaattttoooorrrr((((3333XXXXtttt))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))XXXXttttSSSSeeeettttKKKKeeeeyyyyTTTTrrrraaaannnnssssllllaaaattttoooorrrr((((3333XXXXtttt))))
  71.  
  72.  
  73.  
  74.           _p_r_o_c      Specifies the procedure that is to perform key
  75.                     translations or conversions.
  76.  
  77.           _s_t_a_r_t     Specifies the first KeySym for which this
  78.                     converter is valid.
  79.  
  80.           _s_t_o_p      Specifies the last KeySym for which this converter
  81.                     is valid.
  82.  
  83.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  84.           The _X_t_S_e_t_K_e_y_T_r_a_n_s_l_a_t_o_r function sets the specified procedure
  85.           as the current key translator.  The default translator is
  86.           _X_t_T_r_a_n_s_l_a_t_e_K_e_y, an _X_t_K_e_y_P_r_o_c that uses Shift and Lock
  87.           modifiers with the interpretations defined by the core
  88.           protocol.  It is provided so that new translators can call
  89.           it to get default KeyCode-to-KeySym translations and so that
  90.           the default translator can be reinstalled.
  91.  
  92.           The _X_t_T_r_a_n_s_l_a_t_e_K_e_y_c_o_d_e function passes the specified
  93.           arguments directly to the currently registered KeyCode to
  94.           KeySym translator.
  95.  
  96.           The _X_t_R_e_g_i_s_t_e_r_C_a_s_e_C_o_n_v_e_r_t_e_r registers the specified case
  97.           converter.  The start and stop arguments provide the
  98.           inclusive range of KeySyms for which this converter is to be
  99.           called.  The new converter overrides any previous converters
  100.           for KeySyms in that range.  No interface exists to remove
  101.           converters; you need to register an identity converter.
  102.           When a new converter is registered, the Intrinsics
  103.           refreshes the keyboard state if necessary.  The default
  104.           converter understands case conversion for all KeySyms
  105.           defined in the core protocol.
  106.  
  107.           The _X_t_C_o_n_v_e_r_t_C_a_s_e function calls the appropriate converter
  108.           and returns the results.  A user-supplied _X_t_K_e_y_P_r_o_c may need
  109.           to use this function.
  110.  
  111.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  112.           _X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s - _C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e
  113.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.